home *** CD-ROM | disk | FTP | other *** search
/ Software USA 5 #5 / Software USA Volume 5.05.iso / mac / Home&Office / Telnet / Mocha Telnet Help < prev    next >
Text File  |  1998-05-25  |  13KB  |  411 lines
  1. #H                        Mochasoft Help System  
  2.  
  3. Contents:
  4. 
  5.    #040 1. How to use MochaSoft Help System
  6.    #042 2. How to make a connection
  7.    #041 3. Menu system
  8.    #001 4. Vt220 keyboard mapping#
  9.    #002 5. Change keyboard mapping#
  10.    #003 6. Change character mapping#
  11.    #004 7. Press F18 in an application#
  12.    #006 8. Check for latest version#
  13.    #007 9. Order Mocha Mac Telnet#
  14.    #00810. Technical Support#
  15.  
  16. &040Help System
  17.  
  18. The help window can be started from a dialog box, which has a help
  19. button, or from the menu option Mocha Help or pressing the Help Key
  20.  
  21. Inside  the Help Window, it is possible to jump to topics which are 
  22. marked with an underscore.
  23.  
  24. Near the bottom of the help window are a set of navigation buttons:
  25.  
  26. (Contents)  :  Jump to the Contents page
  27. (Back)      :  Goto recently viewed page
  28. (Forward)   :  Goto recently viewed page
  29. (Close)     :  Close the Help System
  30.  
  31. &042 How to make a connection
  32.  
  33. Mocha Telnet can be started in two ways:
  34.  
  35.   1) Click on file mtelnet (application program)
  36.   2) Click on mtelnet document (an example called telnet - myhost
  37.                                 is included with the installation 
  38.                                 package)
  39.  
  40. Mocha Telnet will read the configuration from the file it is started
  41. from. This makes it possible to save different configurations as 
  42. mtelnet documents.
  43.  
  44. The license key information is also stored in the mtelnet document,
  45. and will be checked at program start. It is possible to store the 
  46. license information with the mtelnet application program. Click on 
  47. the file, and enter the license information at menu - settings - 
  48. license dialog box. Hereafter it is not necessary to type in the 
  49. license information for all mtelnet documents. The only problem with
  50. this solution, occur if a new version of Mocha Mac Telnet is 
  51. installed, hereafter it is necessary to enter the license key again.
  52.  
  53. We will recommend using the mtelnet document to start Mocha Mac Telnet.
  54. This gives the possibility to install new versions of the program, 
  55. without losing the configuration. Use the normal File Duplicate command
  56. to make a copy of the mtelnet document. 
  57.  
  58.                                 
  59. &041Menu System:
  60.  
  61. The classic Macintosh pull-down menu - the strip at the top of the 
  62. screen, can be selected with a mouse click.
  63.  
  64. Following menu's are available:
  65.  
  66. #009File menu#
  67. #010Edit menu#
  68. #011View menu#
  69. #012Settings menu#
  70. #013Help menu# (Only for OS 8.x)
  71.  
  72. &009File menu commands
  73.  
  74. The File menu offers the following commands:
  75.  
  76. #014Connect#      Open a new window and create a session with the 
  77.              selected host.
  78. #015Disconnect#   Close a session to a Host.
  79. #016Print Setup#  Define printer parameters.
  80. #017Print Screen# Print current screen.
  81. #018Quit#         Exits Mocha Mac Telnet.
  82.  
  83.  
  84. &010Edit menu commands
  85.  
  86. The Edit menu offers the following commands:
  87.  
  88. #019Copy#           Copies data from the screen to the clipboard.
  89. #020Paste#          Pastes data from the clipboard into the screen 
  90.                at cursor position.
  91. #021Reset Terminal# Reset the display to a known state. 
  92.               
  93. &011View menu commands
  94.  
  95. The View menu offers the following commands:
  96.  
  97. #022Screen width 132#  Select if to use 24*80 or 24*132 screen size.
  98.  
  99. &012Settings menu commands
  100.  
  101. The Settings menu is used to define the configuration of Mocha Telnet. 
  102.  
  103. #023Font#               Select font type to use in the display.
  104. #024Font Size#          Select font size for 24*80 screen.
  105. #025Font Size 132 Mode# Select font size for 24*132 screen.
  106. #026Colors#             Define colors in the display
  107. #027Print Font Size#    Select size of characters on printer.
  108. #028Auto Login#         Save login id and password here, to speed up 
  109.                    the login procedure.
  110. #029License#            Add license key, to make Your Mocha Mac Telnet legal.
  111. #030Termtype#           Selects telnet terminal type.
  112. #031Local Echo#         Defines if characters typed on the keyboard should
  113.                    be echoed local on the screen.
  114. #032Autowrap#           If the cursor should jump to next line at position 
  115.                    80, can be defined.
  116. #033Swap LF to CR#      Select if the Return key should send CR or CRLF.
  117.  
  118. &013Help menu commands (Only OS 8.x)
  119.  
  120. The Help menu offers the following commands, which provide you assistance 
  121. with this application: 
  122.  
  123. About Balloon Help Gives information about general Macintosh help system
  124. Show Balloons      Turn Balloon help on/off
  125. #040Mocha Telnet Help#  Offers you this help window
  126. #037About#              Displays the version and license information 
  127.  
  128. &014Connect command (File menu)
  129.  
  130. Use this command to create a new connection to a Host. 
  131.  
  132.   Host :  Name of the host. Either an TCP/IP address as 155.22.11.2 
  133.           or a symbolic name.  
  134.   Port :  Most Telnet applications uses port 23.
  135.  
  136.   Use as default host : 
  137.  
  138.      If this checkbox is enabled, Mocha Telnet will login without
  139.      user action, when it is started.
  140.  
  141. &015Disconnect command (File menu)
  142.  
  143. Use this command to disconnect from a Host.
  144.  
  145.  
  146. &018Quit command (File menu)
  147.  
  148. Use this command to end your Mocha Mac Telnet program. All active 
  149. sessions will be terminated. 
  150.  
  151.  
  152. &030Term Type (Settings menu)
  153.  
  154. Use this command to define the telnet Terminal type. As default it 
  155. is VT220.This type is send to the Host on session setup, and will be 
  156. saved as the environment variable TERM.
  157.  
  158. &019Copy command (Edit menu)
  159.  
  160. Use this command to copy selected data onto the clipboard.  
  161. This command is unavailable if there is no data currently selected. 
  162. Data is selected with pressing the mouse key and moving the 
  163. mouse over the area to select.
  164.  
  165. Copying data to the clipboard replaces the contents previously 
  166. stored there.
  167.  
  168. &020Paste command (Edit menu)
  169.  
  170. Use this command to insert a copy of the clipboard contents at 
  171. the cursor. This command is unavailable if the clipboard is empty. 
  172.  
  173. &021Reset Terminal command (Edit menu)
  174.  
  175. Use this command to reset the terminal to a known state. If the 
  176. user has send a binary file to the screen, the screen could look 
  177. less friendly.
  178.  
  179. &022Screen width 132 (View menu)
  180.  
  181. Use this command to force the screen between 24 * 80 and 
  182. 24 *132 mode. In most cases the host will request Mocha Mac Telnet
  183. for the correct size. 
  184.  
  185. &038Scroll bar
  186.  
  187. Displayed at the right edge of the document window. You can use the
  188. mouse to scroll the latest 100 lines.
  189.  
  190. &037About command (Help menu)
  191.  
  192. Use this command to display license and version number of your copy 
  193. of Mocha Mac Telnet
  194.  
  195. &039Title Bar
  196.  
  197. The title bar is located along the top of a window.  It contains 
  198. the Mocha Mac Telnet name and the host connected to.
  199.  
  200. &023Font
  201.  
  202. Changes font type with this menu option. Only non proportional fonts as 
  203. Courier and Monaco will give a good result for a terminal emulator. 
  204. Other fonts will look silly, and on many Macintosh systems run very slow.
  205.  
  206. &024Font Size
  207.  
  208. The window will change size to use the selected font size.
  209.  
  210. &025Font Size mode 132
  211.  
  212. The window will change size to use the selected font size. The screen 
  213. must be in mode 80*132 before this font size is active.
  214.  
  215. &026Color
  216.  
  217. Define colors for text, background and cursor.
  218.  
  219. &027Print Font Size
  220.  
  221. Use this menu option to define the size of characters on the printer
  222.  
  223. &028Auto Login
  224.  
  225. To make it easier for the novice to use Mocha Mac Telnet to connect to 
  226. a single host, it is possible to define an automatic login sequence. 
  227. Of course there is not much security involved doing it!
  228.  
  229. Options
  230.  
  231. Search and Response
  232.  
  233. It is possible to define a search string, and a response string which 
  234. is send back to the host on a match.
  235.  
  236. Example:
  237.  
  238. Search : Login          Response : anonymous\012
  239. Search : Password       Response: mypassword\012
  240.  
  241. To include characters as CR and LF, use the octale notation :
  242.  
  243. \abc = octal value. (LF = \012 and CR = \015)
  244.  
  245.  
  246. &029License
  247.  
  248. After ordering Mocha Mac Telnet from MochaSoft, a license key will 
  249. be received. Enter the key together with the Company Name given on 
  250. the Order. As there is link between the Company name and license key 
  251. it is important to enter both very careful.
  252.  
  253.  
  254. &031Local Echo
  255.  
  256. It is possible to let all characters typed on the keyboard be displayed 
  257. on the screen as default. Normally this is not a good idea. If the host 
  258. wants to run in this mode, it can ask Mocha Mac Telnet direct. 
  259. Most hosts will overwrite this parameter in the startup negotiation.
  260.  
  261.  
  262. &032Autowrap
  263.  
  264. Autowrap defines, if the cursor should jump to the start of the next line, 
  265. when it exceeds the end of a line.
  266.  
  267.  
  268. &033Swap LF to CRLF
  269.  
  270. This parameter defines if <RETURN> key should send <cr> <lf>
  271. or just <cr>.
  272.  
  273. &007How to Order Mocha Mac Telnet
  274.  
  275. It is possible to buy Mocha Mac Telnet via the Internet. 
  276. Visit www.mochasoft.dk , and get the latest information about the 
  277. products and prices. Also check out the Java version of Mocha Telnet.
  278.  
  279.        Single User license.....:  25 USD
  280.        Company license.........: 250 USD     
  281.  
  282.  
  283. &006How to Check for latest Version
  284.  
  285. Visit the MochaSoft home page at www.mochasoft.dk, and receive 
  286. information about the latest development of the product. The version 
  287. of Your copy of Mocha Mac Telnet can be checked in menu help-about.
  288.  
  289.  
  290. &002Change keyboard mapping
  291.  
  292. Mocha Mac Telnet comes with a default VT220 keyboard. It is possible to 
  293. customize all function keys with a keyboard mapping file. 
  294.  
  295. The keyboard mapping file is installed in the Mocha Mac telnet Folder, 
  296. and named "Mocha Telnet Keyboard"
  297. You can edit it with a normal ascii editor as "Simple Text".
  298. Each key is described with a line as:
  299.  
  300. keycodes state mode value
  301.  
  302. where
  303.  
  304.   keycodes : keycode send of Macintosh keyboard
  305.   state    : if a special key is selected: 1=shift key 
  306.              2=ctrl key 4=option key 
  307.   mode     : 1=ansi 2=vt52 4 = application mode
  308.   value    : character sequence to send. It is possible to use an 
  309.              octal value.
  310.              The syntax is \xxx ,where xxx is the octal value
  311.  
  312. Example:
  313.  
  314. 35 0  0 "\033"         
  315. 7a 0  0 "\033[11~"      
  316. 78 0  0 "\033[12~"     
  317. 63 0  0 "\033[13~"     
  318.  
  319. Apple Extended Keyboard - key Codes:
  320.  
  321. 35    7a 78 63 76  60 61 62 64  65 6d 67 6f  69 6b 71   
  322. 32 12 13 14 15 17 16 1a 1c 19 1d 1b 18  33   72 73 74   47 51 4b 43
  323.  30 0c 0d 0e 0f 11 10 20 22 1f 23 21 1e 2a   75 77 79   59 5b 5c 4e 
  324.  39  00 01 02 03 05 04 26 28 25 29 27  24               56 57 58 45
  325.  38   06 07 08 09 0b 2d 2e 2b 2f 2c    38       7e      53 54 55
  326. 3b  3a  37          31          37 3a 3b     7b 7d 7c     52  41 4c
  327.  
  328.  
  329. Apple Extended keyboard - key Legends:
  330.  
  331. Esc f1 f2 f3 f4  f5 f6 f7 f8 f9 f10 f11 f12 f13   f14 f15         
  332.  ` 1  2  3  4  5  6  7  8  9  0  - = del    help home up       =  /  *         
  333. tab  q  w  e  r  t  y  u  i  o  p  [  ] \   del  end  down  7  8  9  -
  334. caps  a  s  d  f  g  h  j  k  l  ; ´ enter                  4  5  6  +
  335. shift  z  x  c  v  b  n  m  ,  .  / shift         up        1  2  3
  336. ctrl option apple ----space---apple opt ctrl left down right 0    .  enter 
  337.  
  338.  
  339.  
  340. &004How to Press F18 in an application
  341.  
  342. A standard Extended Macintosh keyboard will only have keys F1 - F15.
  343. To select keys higher than F15, following default mapping is used:
  344.  
  345. Shift F1= F16
  346. Shift F2= F17
  347. Shift F3= F18
  348. Shift F4= F19
  349. Shift F5= F20
  350.  
  351. &001VT220 Keyboard mapping
  352.  
  353. Mocha Mac Telnet comes with a default VT220 keyboard. 
  354.  
  355.  
  356.  Mac-Key       VT220-Key             
  357. -------------------------------   
  358.   f1              f1              
  359.   f2              f2                 
  360.   f3              f3                 
  361.   f4              f4                 
  362.   f5              f5              
  363.   f6              f6              
  364.   f7              f7              
  365.   f8              f8              
  366.   f9              f9              
  367.   f10            f10              
  368.   f11            f11              
  369.   f12            f12              
  370.   f13            f13              
  371.   f14            f14              
  372.   f15            f15              
  373.               
  374.                                   
  375.  Mac-Key       VT220-Key          
  376. -------------------------------    
  377.   shift f1       f16             
  378.   shift f2       f17             
  379.   shift f3       f18             
  380.   shift f4       f19         
  381.   shift f5       f20                                                
  382.  
  383. The auxiliary keypad can also be used, and there is no change in the 
  384. positions for these keys between Macintosh and Vt220 keyboard.
  385.  
  386.  
  387. &008Technical Support
  388.  
  389. Visit the MochaSoft home page at www.mochasoft.dk, and receive
  390. information about how to contact MochaSoft.
  391.  
  392. &003Character mapping
  393.  
  394. The Character mapping file is installed in the Mocha Telnet Folder, and 
  395. named "Mocha Telnet keyboard".
  396. This file is also used for the keyboard mapping.
  397. You can edit it with a normal ascii editor as "Simple Text".
  398. Each character mapping is described with a line as:
  399.  
  400. !xx yy
  401.  
  402. where xx is ASCII (macintosh) value in hexadecimal and
  403. yy is the ANSI value used of the host.
  404.  
  405. Example:
  406.  
  407. !98 f2
  408.  
  409. means when the Unix hosts sends hexadecimal character f2, it is
  410. translated to 98 before it is displayed on the screen.
  411.